From 1665ba69de0b3101367c131b237a386c55e2f407 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Mon, 1 Nov 2004 20:59:56 +0000
Subject: [PATCH] Add an intro.

2004-11-01  Matthias Clasen  <mclasen@redhat.com>

	* gtk/tmpl/gtkcellrendererpixbuf.sgml: Add an intro.
---
 docs/reference/ChangeLog                           |  2 ++
 docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml | 14 ++++++++++++++
 2 files changed, 16 insertions(+)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index f7c0f33455..67a094e789 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,5 +1,7 @@
 2004-11-01  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/tmpl/gtkcellrendererpixbuf.sgml: Add an intro.
+
 	* gtk/tmpl/gtkfilechooserbutton.sgml: Move some docs inline.
 
 	* gtk/tmpl/gtkaboutdialog.sgml: Small update.
diff --git a/docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml b/docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml
index 575380df17..b574076f70 100644
--- a/docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml
+++ b/docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml
@@ -6,7 +6,21 @@ Renders a pixbuf in a cell
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
+A #GtkCellRendererPixbuf can be used to render an image in a cell. It allows to render 
+either a given #GdkPixbuf (set via the <link linkend="GtkCellRendererPixbuf--pixbuf">pixbuf</link>
+property) or a stock icon (set via the <link linkend="GtkCellRendererPixbuf--stock-id">stock-id</link>
+property).
+</para>
 
+<para>
+To support the tree view, #GtkCellRendererPixbuf also supports rendering two alternative pixbufs,
+when the <link linkend="GtkCellRenderer--is-expander">is-expander</link> property is %TRUE.
+If the <link linkend="GtkCellRenderer--is-expander">is-expander</link> property is %TRUE and
+the <link linkend="GtkCellRendererPixbuf--pixbuf-expander-open">pixbuf-expander-open</link> property
+is set to a pixbuf, it renders that pixbuf, if the 
+<link linkend="GtkCellRenderer--is-expander">is-expander</link> property is %FALSE and
+the <link linkend="GtkCellRendererPixbuf--pixbuf-expander-closed">pixbuf-expander-closed</link> property
+is set to a pixbuf, it renders that one. 
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
-- 
2.30.2